home *** CD-ROM | disk | FTP | other *** search
/ Light ROM 1 / LIGHT-ROM 1 (Amiga Library Services)(1994).iso / ffdisks / d903.lha / MICE / Mice_Doc.Eng < prev    next >
Text File  |  1993-08-26  |  11KB  |  436 lines
  1.  
  2.         ******************************************
  3.         **                    **
  4.         **         MICE            **
  5.         **          V1.3 (04.93)        **
  6.         **      by  Pierre-Louis MANGEARD    **
  7.         **                    **
  8.         ******************************************
  9.  
  10.  
  11.  
  12.  
  13.  
  14. MICE  means  :   My  Image  Code  Editor.   MICE generates source code from
  15. standard IFF pictures, just as brushes from Deluxe Paint.
  16.  
  17. MICE works with the req.library so take care that it features in your libs:
  18. directory.
  19.  
  20. Launch MICE from the CLI or from it's WorkBench icon.
  21.  
  22. MICE  generates  a  structured  source  code  for  DEVPAC 2 in assembly and
  23. LATTICE/SAS in C language.  For others, make the modifications yourself.
  24.  
  25.  
  26.  
  27. INSTRUCTIONS FOR USE :
  28. --------------------
  29.  
  30. To  understand  MICE  functions well please follow the instructions step by
  31. step.
  32.  
  33. Before  all  manipulations, you must run your favourite editor, but only if
  34. it has a file requester.
  35.  
  36. To  proceed with this  tests, you will find with this doc a directory named
  37. 'Brushes'  that  contains  three  IFF  brushes  names  'Brol',  'Gazm', and
  38. 'Rototo'.
  39.  
  40. For  each  test,  launch  MICE  from  its  icon  or from shell and open the
  41. 'Brushes' directory in the file requester.
  42.  
  43.  
  44.  
  45. I.- Simple-selecting :
  46.     ----------------
  47.  
  48. 1 -> 
  49. Double-click  on  file  'Rototo'.   The filerequester disappears.  A window
  50. opens  :   it  contains  a  few  boolean  gadgets and a string gadget named
  51. 'SOURCE CODE FILENAME'.
  52.  
  53. -  4 gadgets are pre-selected ('ASSEMBLY', 'IMAGE STRUCT', 'IMAGE DATA' and
  54. 'COMMENTS')
  55.  
  56. - one gadget is ghosted ('MULTIFILES')
  57.  
  58. - the string gadget contains the mention 'RAM:Mice.Code'
  59.  
  60.  
  61. 2 ->
  62. Now click on the 'DO & QUIT' gadget.  The window closes.
  63.  
  64. 3 ->
  65. From  your  editor,  load  from RAM:  the file that has been newly created,
  66. named 'Mice.Code'.
  67.  
  68.  
  69. This  file  contains  the  Image structure and the image datas of the brush
  70. 'Rototo',  coded  in  assembly,  with  comments.   This  code is immediatly
  71. available for GenIm2.
  72.  
  73. Note  that  the  code  retrieves  the filename of the brush, and the labels
  74. 'ImageRototo' and 'ImageDataRototo' are generated.
  75.  
  76. So, for the maximum efficiency of MICE, you must follow some rules when you
  77. name your brushes.  Please see the chapter 'LABELS AND FILENAMES'.
  78.  
  79.  
  80.  
  81. II.- Option 'COMMENTS' :
  82.      -----------------
  83.  
  84. In  the  previous test, the 'COMMENTS' option was selected by default.  Now
  85. let's see what that means exactly.
  86.  
  87.  
  88. 1 ->
  89. Double-click on file 'Rototo'.
  90.  
  91. 2 ->
  92. Click on the 'COMMENTS' gadget.  It is now deselected.
  93.  
  94. 3 ->
  95. In the string gadget, rename the output file, for example 'RAM:Mice1.code'.
  96.  
  97. 4 ->
  98. Click on the 'DO & QUIT' gadget.
  99.  
  100. 5 ->
  101. Load  this new file in a new window of your editor, so that you can compare
  102. it with the previous code.
  103.  
  104.  
  105. This  file  contains  the  Image structure and the image datas of the brush
  106. 'Rototo', coded in assembly, now WITHOUT comments.
  107.  
  108.  
  109.  
  110. III.- Option 'PALETTE' :
  111.       ----------------
  112.  
  113. This option adds the code of the palette.
  114.  
  115. To  see  the  result,  repeat  the  same  manipulations than I and II, with
  116. 'PALETTE' option.
  117.  
  118.  
  119.  
  120. IV.- Option 'C' :
  121.      ----------
  122.  
  123. This option makes MICE generate C code instead of assembly code.
  124.       
  125. To  see  the result, repeat the same manipulations than I, II, and III, but
  126. with the 'C' option.
  127.  
  128.  
  129.  
  130. V.- Multi-Selecting files without the 'MULTIFILES' option :
  131.     -----------------------------------------------------
  132.  
  133. V.1.- 'ASSEMBLY' option :
  134.  
  135.  
  136. 1 ->
  137. Press  the  SHIFT  key  and  click  successively on the three files 'Brol',
  138. 'Gazm', and 'Rototo'.
  139.  
  140. 2 ->
  141. Click on the 'OK' gadget of the filerequester.
  142.  
  143. 3 ->
  144. Select the 'PALETTE' option.
  145.  
  146. 4 ->
  147. Click on the 'DO & QUIT' gadget.
  148.  
  149. 5 ->
  150. Load 'RAM:Mice.Code' in your editor.
  151.  
  152.  
  153. The code you have obtained is made of three sections :
  154.  
  155. - SECTION Palette,DATA        with the palette
  156. - SECTION ImageStructure,DATA    with all the Image structures
  157. - SECTION ImageData,DATA_C    with all the Image datas
  158.  
  159. This  setting  allows  you  to  handle  great blocks of datas with only one
  160. cut-paste.
  161.  
  162. The  palette  features only once at the beginning of the file.  That is the
  163. palette  of  the  first  selected file, 'Brol'.  If there was no palette in
  164. 'Brol',  or if its palette was corrupted, there would be no palette section
  165. in Mice.Code.
  166.  
  167.  
  168. V.2.- 'C' option :
  169.  
  170.  
  171. The C code is differently structured than assembly code.
  172.  
  173. Repeat the same manipulations than in part V.1., but with the 'C' option.
  174.  
  175. The  palette features in first place, and the image datas are not separated
  176. of the Image structures.
  177.  
  178. Since  the  LATTICE/SAS  allows  the  use  of  the keyword 'chip', and that
  179. guarantees  that data within {} will be loaded into CHIP memory, then it is
  180. not necessary to separate the different types of datas.
  181.  
  182.  
  183.  
  184. VI.- Multi-Selecting with the 'MULTIFILES' option and without 'PALETTE' :
  185.      ------------------------------------------------------------------
  186.  
  187. 1 ->
  188. Press  the  SHIFT  key  and  click  successively on the three files 'Brol',
  189. 'Gazm', and 'Rototo'.
  190.  
  191. 2 ->
  192. Click on the 'OK' gadget of the filerequester.
  193.  
  194. 3 ->
  195. Select  the  'MULTIFILES'  option.   Note  that  the 'SOURCE CODE FILENAME'
  196. gadget now indicates 'RAM:' instead of 'RAM:Mice.Code'.
  197.  
  198. 4 ->
  199. Click on the 'DO & QUIT' gadget.
  200.  
  201. 5 ->
  202. On  the  filerequester of your editor, you can now discover three new files
  203. in  RAM:,  named 'Brol.Code', 'Gazm.Code', and 'Rototo.Code'.  Each of them
  204. contains the image structure and the image data of its parent brush.
  205.  
  206.  
  207.  
  208. VI.- Multi-Selecting with the 'MULTIFILES' option and with 'PALETTE' :
  209.      ---------------------------------------------------------------
  210.  
  211. 1 ->
  212. Press  the  SHIFT  key  and  click  successively on the three files 'Brol',
  213. 'Gazm', and 'Rototo'.
  214.  
  215. 2 ->
  216. Click on the 'OK' gadget of the filerequester.
  217.  
  218. 3 ->
  219. Select the 'PALETTE' option.
  220.  
  221. 4 ->
  222. Select the 'MULTIFILES' option.
  223.  
  224. 5 ->
  225. Click on the 'DO & QUIT' gadget.
  226.  
  227. 6 ->
  228. The  window  closes  and  a  requester  opens  with the following message :
  229. 'Repeat palette in each file ?'.  You may answer 'Yes' or 'No' :
  230.  
  231.  
  232. VII.1.  Answer 'Yes' to the requester :
  233.  
  234.  
  235. Load  successively  the  three files in RAM:  'Brol.Code', 'Gazm.Code', and
  236. 'Rototo.Code'.   Each of them contains the palette, the image structure and
  237. the  image  data  of  its parent brush.  But this time, the palette of each
  238. file    is    named    respectively    'PaletteBrol',   'PaletteGazm'   and
  239. 'PaletteRototo'.
  240.  
  241.  
  242. VII.2.  Answer 'No' to the requester :
  243.  
  244.  
  245. On the filerequester of your editor, you discover a new file in RAM:, named
  246. 'Palette.Code',  that  contains  the  palette.   However,  the three others
  247. files,  'PaletteBrol',  'PaletteGazm'  and  'PaletteRototo', do not anymore
  248. contain palette.
  249.  
  250.  
  251.  
  252. VIII.- Multi-Selecting files with only 'PALETTE' option :
  253.        ------------------------------------------------
  254.  
  255. In  most cases, when you want to code IFF brushes, they are parts of a same
  256. screen,  and  have  the  same palette.  That is why MICE generates only one
  257. palette, except in the case described in VII.1.
  258.  
  259. But  if you select ONLY the 'PALETTE' option, MICE will understand that you
  260. need the palette of each selected brush.
  261.  
  262. So  MICE will generate either a file with the three palettes 'PaletteBrol',
  263. 'PaletteGazm'  and  'PaletteRototo',  or,  if  you have chosen 'MULTIFILES'
  264. option,  three  files  'Brol.Code',  'Gazm.Code',  and  'Rototo.Code'  that
  265. contain respectively the palette of the parent brush.
  266.  
  267.  
  268.  
  269. IX.- 'SHOW IFF' :
  270.      ----------
  271.  
  272. IX.1.- Simple-Selecting :
  273.  
  274.  
  275. 1 ->
  276. Double-click on file 'Rototo'.
  277.  
  278. 2 ->
  279. Click on the gadget 'SHOW IFF'.
  280.  
  281. 3 ->
  282. A screen opens that shows you the brush 'Rototo'.
  283.  
  284. 4 ->
  285. Click  on  the left mousebutton.  The screen closes and you are back to the
  286. window.
  287.  
  288.  
  289. IX.2.- Multi-Selecting :
  290.  
  291.  
  292. 1 ->
  293. Press  the  SHIFT  key  and  click  successively on the three files 'Brol',
  294. 'Gazm', and 'Rototo'.
  295.  
  296. 2 ->
  297. Click on the 'OK' gadget of the filerequester.
  298.  
  299. 3 ->
  300. Click on the gadget 'SHOW IFF'.
  301.  
  302. 4 ->
  303. A screen opens that shows you the brush 'Brol'.
  304.  
  305. 5 ->
  306. Click  on  the  left mousebutton.  The screen closes and a new screen opens
  307. with the brush 'Gazm'.
  308.  
  309. 6 ->
  310. Click  on  the  left mousebutton.  The screen closes and a new screen opens
  311. with the brush 'Rototo'.
  312.  
  313. 7 ->
  314. Click  on  the left mousebutton.  The screen closes and you are back to the
  315. window.
  316.  
  317.  
  318.  
  319. X.- Options 'DO', 'DO & QUIT', 'CANCEL', 'QUIT' :
  320.     -------------------------------------------
  321.  
  322. The  'DO  &  QUIT' option allows you to code your image(s) and to quit MICE
  323. immediatly.
  324.  
  325. The  'QUIT'  option  allows you to code your image(s) and to go back to the
  326. filerequester for a new selection.
  327.  
  328. The  'CANCEL' option allows you to go back to the filerequester without any
  329. effect.
  330.  
  331. The 'QUIT' option allows you to quit MICE without any effect.
  332.  
  333.  
  334.  
  335. LABELS AND FILENAMES :
  336.     --------------------
  337.  
  338. MICE  retrieves  the  filename of your brush to generate its labels.  It is
  339. very  handy because you can create your label at the very beginning of your
  340. program, whilst you are drawing your bobs, images, gadgets, etc.
  341.  
  342. MICE  converts  the first letter of the filename in upper case if it is not
  343. yet.
  344.  
  345. For  example,  from  a  brush named 'rototo', MICE will generate the labels
  346. 'ImageRototo', 'ImageDataRototo' and, eventually, 'PaletteRototo'.
  347.  
  348. Since the filename becomes label, it must follow some rules :
  349.  
  350. - filename must begin by ASCII a-z, A-Z, or _
  351.  
  352. - filename must not contain other character than a-z, A-Z, 0-9 or _
  353.  
  354. - then, filename must not contain either space or accentuated characters.
  355.  
  356.  
  357. Examples of valid filenames :
  358.  
  359.     Rototo
  360.     veRGlUtoMItrOPhLerCABle
  361.     Ramb0
  362.     R2D2
  363.     Louis_XIV
  364.     _fna
  365.     __vlu
  366.  
  367. Examples of non-valid filenames :
  368.  
  369.     Starsky&Hutch
  370.     2001_A_Space_Odyssey
  371.     &%$?#(>*
  372.     _make room !
  373.     yékéké
  374.     etc...
  375.  
  376.  
  377. - MICE refuses a file if the first letter of the name is not available.
  378.  
  379. - MICE  accepts filenames that contains illegal characters  :  it keeps all
  380. the available part and ignore all the following.  Here are some examples of
  381. what that means :
  382.  
  383.     Starsky&Hutch    gives the label    ImageStarsky
  384.     brush.1           "      "    ImageBrush
  385.     brush.2           "      "    ImageBrush
  386.     brush(!&?<>)       "      "    ImageBrush
  387.     _make room !       "      "    Image_make
  388.     etc...           "      "    ImageEtc
  389.  
  390.  
  391. So  be  sure  that  the  first significant characters of your filenames are
  392. different for each file.
  393.  
  394. In  these examples, the two filenames 'brush.1' and 'brush.2' give the same
  395. label.   That would involve an error message at the assembly or compilation
  396. time.
  397.  
  398. If  you  have  chosen  the  'MULTIFILES' option, only one file will appear,
  399. named  'Brush.Code'.  It contains the source code of the last file that has
  400. been  treated,  because  the two generated files had the same filename, and
  401. the last saved has crashed the previous.
  402.  
  403.  
  404.  
  405.  
  406.     ================***************************==================
  407.             *=*=*=*=*=*=*=*=*=*=*=*=*=*
  408.  
  409.  
  410.  
  411. Please write to :
  412.  
  413.             Pierre-Louis MANGEARD
  414.             95, chemin Kennedy
  415.             97432 LA RAVINE DES CABRIS
  416.             Ile de la Réunion
  417.             FRANCE
  418. or
  419.             Pierre-Louis MANGEARD
  420.             Médiathèque de Saint-Pierre
  421.             BP 396
  422.             97410 SAINT PIERRE
  423.             Ile de la Réunion
  424.             FRANCE
  425. or
  426.             Pierre-Louis MANGEARD
  427.             15, rue des Cailles
  428.             Plateau Caillou
  429.             97460 SAINT PAUL
  430.             Ile de la Réunion
  431.             FRANCE
  432.  
  433.  
  434. tel: 19 ~ 262  57 40 28
  435.  
  436.